Node / meshtastic / Meshtastic-Android / files / core / model / src / commonMain / kotlin / org / meshtastic / core / model / util / SharedContact.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tf0883e@fileTb4b4b4:Te6edf3SuppressTb4b4b4(Ta5d6ff"Ta5d6ffTooManyFunctionsTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffSwallowedExceptionTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffTooGenericExceptionCaughtTa5d6ff"Tb4b4b4)

Tff7b72package T7ee787org.meshtastic.core.model.util

Tff7b72import T7ee787okio.ByteString

Tff7b72import T7ee787okio.ByteString.Companion.decodeBase64

Tff7b72import T7ee787okio.ByteString.Companion.toByteString

Tff7b72import T7ee787org.meshtastic.core.common.util.CommonUri

Tff7b72import T7ee787org.meshtastic.proto.SharedContact

Tff7b72import T7ee787org.meshtastic.proto.User

T8b949e/**

* Return a [SharedContact] that represents the contact encoded by the URL.

*

* @throws MalformedMeshtasticUrlException when not recognized as a valid Meshtastic URL

*/

Tf0883e@ThrowsTb4b4b4(Te6edf3MalformedMeshtasticUrlExceptionTff7b72::Te6edf3classTb4b4b4)

Tff7b72fun Te6edf3CommonUriTb4b4b4.Td2a8fftoSharedContactTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3SharedContact Tb4b4b4{

Te6edf3checkSharedContactUrlTb4b4b4(Tb4b4b4)

Tff7b72val Te6edf3data Tff7b72= Te6edf3fragmentTff7b72!!Tb4b4b4.Te6edf3substringBeforeTb4b4b4(Ta5d6ff'?'Tb4b4b4)

Tff7b72return Te6edf3decodeSharedContactDataTb4b4b4(Te6edf3dataTb4b4b4)

Tb4b4b4}

Tf0883e@ThrowsTb4b4b4(Te6edf3MalformedMeshtasticUrlExceptionTff7b72::Te6edf3classTb4b4b4)

Tff7b72private Tff7b72fun Te6edf3CommonUriTb4b4b4.Td2a8ffcheckSharedContactUrlTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3h Tff7b72= Te6edf3hostTff7b72?.Te6edf3lowercaseTb4b4b4(Tb4b4b4) Tff7b72?: Ta5d6ff"Ta5d6ff"

Tff7b72val Te6edf3isCorrectHost Tff7b72= Te6edf3h Tff7b72=Tff7b72= Te6edf3MESHTASTIC_HOST Tff7b72|Tff7b72| Te6edf3h Tff7b72=Tff7b72= Ta5d6ff"Ta5d6ffwww.Tffd700$Te6edf3MESHTASTIC_HOSTTa5d6ff"

Tff7b72val Te6edf3segments Tff7b72= Te6edf3pathSegments

Tff7b72val Te6edf3isCorrectPath Tff7b72= Te6edf3segmentsTb4b4b4.Te6edf3any Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3equalsTb4b4b4(Ta5d6ff"Ta5d6ffvTa5d6ff"Tb4b4b4, Te6edf3ignoreCase Tff7b72= Tff7b72trueTb4b4b4) Tb4b4b4}

Tff7b72val Te6edf3frag Tff7b72= Te6edf3fragment

Tff7b72if Tb4b4b4(Te6edf3fragTb4b4b4.Te6edf3isNullOrBlankTb4b4b4(Tb4b4b4) Tff7b72|Tff7b72| Tff7b72!Te6edf3isCorrectHost Tff7b72|Tff7b72| Tff7b72!Te6edf3isCorrectPathTb4b4b4) Tb4b4b4{

Tff7b72throw Te6edf3MalformedMeshtasticUrlExceptionTb4b4b4(

Ta5d6ff"Ta5d6ffNot a valid Meshtastic URL: host=Tffd700$Te6edf3hTa5d6ff, segments=Tffd700$Te6edf3segmentsTa5d6ff, hasFragment=Tffd700${Tff7b72!Te6edf3fragTb4b4b4.Te6edf3isNullOrBlankTb4b4b4(Tb4b4b4)Tffd700}Ta5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tf0883e@SuppressTb4b4b4(Ta5d6ff"Ta5d6ffThrowsCountTa5d6ff"Tb4b4b4)

Tf0883e@ThrowsTb4b4b4(Te6edf3MalformedMeshtasticUrlExceptionTff7b72::Te6edf3classTb4b4b4)

Tff7b72private Tff7b72fun Td2a8ffdecodeSharedContactDataTb4b4b4(Te6edf3dataTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3SharedContact Tb4b4b4{

Tff7b72val Te6edf3decodedBytes Tff7b72=

Tff7b72try Tb4b4b4{

T8b949e// We use a more lenient decoding for the input to handle variations from different clients

Tff7b72val Te6edf3sanitized Tff7b72= Te6edf3dataTb4b4b4.Te6edf3replaceTb4b4b4(Ta5d6ff'-'Tb4b4b4, Ta5d6ff'+'Tb4b4b4)Tb4b4b4.Te6edf3replaceTb4b4b4(Ta5d6ff'_'Tb4b4b4, Ta5d6ff'/'Tb4b4b4)

Te6edf3sanitizedTb4b4b4.Te6edf3decodeBase64Tb4b4b4(Tb4b4b4) Tff7b72?: Tff7b72throw Te6edf3IllegalArgumentExceptionTb4b4b4(Ta5d6ff"Ta5d6ffInvalid Base64 stringTa5d6ff"Tb4b4b4)

Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3eTb4b4b4: Te6edf3IllegalArgumentExceptionTb4b4b4) Tb4b4b4{

Tff7b72throw Te6edf3MalformedMeshtasticUrlExceptionTb4b4b4(

Ta5d6ff"Ta5d6ffFailed to Base64 decode SharedContact data (Tffd700$Te6edf3dataTa5d6ff): Tffd700${Te6edf3eTff7b72::Te6edf3classTb4b4b4.Te6edf3simpleNameTffd700}Ta5d6ff: Tffd700${Te6edf3eTb4b4b4.Te6edf3messageTffd700}Ta5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tff7b72return Tff7b72try Tb4b4b4{

Te6edf3SharedContactTb4b4b4.Te6edf3ADAPTERTb4b4b4.Te6edf3decodeTb4b4b4(Te6edf3decodedBytesTb4b4b4)

Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3eTb4b4b4: Te6edf3ExceptionTb4b4b4) Tb4b4b4{

Tff7b72throw Te6edf3MalformedMeshtasticUrlExceptionTb4b4b4(

Ta5d6ff"Ta5d6ffFailed to proto decode SharedContact: Tffd700${Te6edf3eTff7b72::Te6edf3classTb4b4b4.Te6edf3simpleNameTffd700}Ta5d6ff: Tffd700${Te6edf3eTb4b4b4.Te6edf3messageTffd700}Ta5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

T8b949e/** Converts a [SharedContact] to its corresponding URI representation. */

Tff7b72fun Te6edf3SharedContactTb4b4b4.Td2a8ffgetSharedContactUrlTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3CommonUri Tb4b4b4{

Tff7b72val Te6edf3bytes Tff7b72= Te6edf3SharedContactTb4b4b4.Te6edf3ADAPTERTb4b4b4.Te6edf3encodeTb4b4b4(Tff7b72thisTb4b4b4)

Tff7b72val Te6edf3enc Tff7b72= Te6edf3bytesTb4b4b4.Te6edf3toByteStringTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3base64UrlTb4b4b4(Tb4b4b4)

Tff7b72return Te6edf3CommonUriTb4b4b4.Te6edf3parseTb4b4b4(Ta5d6ff"Tffd700$Te6edf3CONTACT_URL_PREFIXTffd700$Te6edf3encTa5d6ff"Tb4b4b4)

Tb4b4b4}

T8b949e/** Compares two [User] objects and returns a string detailing the differences. */

Tff7b72fun Td2a8ffcompareUsersTb4b4b4(Te6edf3oldUserTb4b4b4: Te6edf3UserTb4b4b4, Te6edf3newUserTb4b4b4: Te6edf3UserTb4b4b4)Tb4b4b4: Tffa657String Tb4b4b4{

Tff7b72val Te6edf3changes Tff7b72= Te6edf3mutableListOfTff7b72<Tffa657StringTff7b72>Tb4b4b4(Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3oldUserTb4b4b4.Te6edf3id Tff7b72!Tff7b72= Te6edf3newUserTb4b4b4.Te6edf3idTb4b4b4) Te6edf3changesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffid: Tffd700${Te6edf3oldUserTb4b4b4.Te6edf3idTffd700}Ta5d6ff -> Tffd700${Te6edf3newUserTb4b4b4.Te6edf3idTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3oldUserTb4b4b4.Te6edf3long_name Tff7b72!Tff7b72= Te6edf3newUserTb4b4b4.Te6edf3long_nameTb4b4b4) Te6edf3changesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6fflong_name: Tffd700${Te6edf3oldUserTb4b4b4.Te6edf3long_nameTffd700}Ta5d6ff -> Tffd700${Te6edf3newUserTb4b4b4.Te6edf3long_nameTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3oldUserTb4b4b4.Te6edf3short_name Tff7b72!Tff7b72= Te6edf3newUserTb4b4b4.Te6edf3short_nameTb4b4b4) Tb4b4b4{

Te6edf3changesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffshort_name: Tffd700${Te6edf3oldUserTb4b4b4.Te6edf3short_nameTffd700}Ta5d6ff -> Tffd700${Te6edf3newUserTb4b4b4.Te6edf3short_nameTffd700}Ta5d6ff"Tb4b4b4)

Tb4b4b4}

Tf0883e@SuppressTb4b4b4(Ta5d6ff"Ta5d6ffDEPRECATIONTa5d6ff"Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3oldUserTb4b4b4.Te6edf3macaddr Tff7b72!Tff7b72= Te6edf3newUserTb4b4b4.Te6edf3macaddrTb4b4b4) Tb4b4b4{

Te6edf3changesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffmacaddr: Tffd700${Te6edf3oldUserTb4b4b4.Te6edf3macaddrTb4b4b4.Te6edf3base64StringTb4b4b4(Tb4b4b4)Tffd700}Ta5d6ff -> Tffd700${Te6edf3newUserTb4b4b4.Te6edf3macaddrTb4b4b4.Te6edf3base64StringTb4b4b4(Tb4b4b4)Tffd700}Ta5d6ff"Tb4b4b4)

Tb4b4b4}

Tff7b72if Tb4b4b4(Te6edf3oldUserTb4b4b4.Te6edf3hw_model Tff7b72!Tff7b72= Te6edf3newUserTb4b4b4.Te6edf3hw_modelTb4b4b4) Te6edf3changesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffhw_model: Tffd700${Te6edf3oldUserTb4b4b4.Te6edf3hw_modelTffd700}Ta5d6ff -> Tffd700${Te6edf3newUserTb4b4b4.Te6edf3hw_modelTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3oldUserTb4b4b4.Te6edf3is_licensed Tff7b72!Tff7b72= Te6edf3newUserTb4b4b4.Te6edf3is_licensedTb4b4b4) Tb4b4b4{

Te6edf3changesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffis_licensed: Tffd700${Te6edf3oldUserTb4b4b4.Te6edf3is_licensedTffd700}Ta5d6ff -> Tffd700${Te6edf3newUserTb4b4b4.Te6edf3is_licensedTffd700}Ta5d6ff"Tb4b4b4)

Tb4b4b4}

Tff7b72if Tb4b4b4(Te6edf3oldUserTb4b4b4.Te6edf3role Tff7b72!Tff7b72= Te6edf3newUserTb4b4b4.Te6edf3roleTb4b4b4) Te6edf3changesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffrole: Tffd700${Te6edf3oldUserTb4b4b4.Te6edf3roleTffd700}Ta5d6ff -> Tffd700${Te6edf3newUserTb4b4b4.Te6edf3roleTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3oldUserTb4b4b4.Te6edf3public_key Tff7b72!Tff7b72= Te6edf3newUserTb4b4b4.Te6edf3public_keyTb4b4b4) Tb4b4b4{

Te6edf3changesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffpublic_key: Tffd700${Te6edf3oldUserTb4b4b4.Te6edf3public_keyTb4b4b4.Te6edf3base64StringTb4b4b4(Tb4b4b4)Tffd700}Ta5d6ff -> Tffd700${Te6edf3newUserTb4b4b4.Te6edf3public_keyTb4b4b4.Te6edf3base64StringTb4b4b4(Tb4b4b4)Tffd700}Ta5d6ff"Tb4b4b4)

Tb4b4b4}

Tff7b72return Tff7b72if Tb4b4b4(Te6edf3changesTb4b4b4.Te6edf3isEmptyTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4{

Ta5d6ff"Ta5d6ffNo changes detected.Ta5d6ff"

Tb4b4b4} Tff7b72else Tb4b4b4{

Ta5d6ff"Ta5d6ffChanges:Ta5d6ff\Ta5d6ffnTffd700${Te6edf3changesTb4b4b4.Te6edf3joinToStringTb4b4b4(Ta5d6ff"\Te6edf3nTa5d6ff"Tb4b4b4)Tffd700}Ta5d6ff"

Tb4b4b4}

Tb4b4b4}

T8b949e/** Converts a [User] object to a string representation of its fields and values. */

Tff7b72fun Td2a8ffuserFieldsToStringTb4b4b4(Te6edf3userTb4b4b4: Te6edf3UserTb4b4b4)Tb4b4b4: Tffa657String Tb4b4b4{

Tff7b72val Te6edf3fieldLines Tff7b72= Te6edf3mutableListOfTff7b72<Tffa657StringTff7b72>Tb4b4b4(Tb4b4b4)

Te6edf3fieldLinesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffid: Tffd700${Te6edf3userTb4b4b4.Te6edf3idTffd700}Ta5d6ff"Tb4b4b4)

Te6edf3fieldLinesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6fflong_name: Tffd700${Te6edf3userTb4b4b4.Te6edf3long_nameTffd700}Ta5d6ff"Tb4b4b4)

Te6edf3fieldLinesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffshort_name: Tffd700${Te6edf3userTb4b4b4.Te6edf3short_nameTffd700}Ta5d6ff"Tb4b4b4)

Tf0883e@SuppressTb4b4b4(Ta5d6ff"Ta5d6ffDEPRECATIONTa5d6ff"Tb4b4b4)

Te6edf3fieldLinesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffmacaddr: Tffd700${Te6edf3userTb4b4b4.Te6edf3macaddrTb4b4b4.Te6edf3base64StringTb4b4b4(Tb4b4b4)Tffd700}Ta5d6ff"Tb4b4b4)

Te6edf3fieldLinesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffhw_model: Tffd700${Te6edf3userTb4b4b4.Te6edf3hw_modelTffd700}Ta5d6ff"Tb4b4b4)

Te6edf3fieldLinesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffis_licensed: Tffd700${Te6edf3userTb4b4b4.Te6edf3is_licensedTffd700}Ta5d6ff"Tb4b4b4)

Te6edf3fieldLinesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffrole: Tffd700${Te6edf3userTb4b4b4.Te6edf3roleTffd700}Ta5d6ff"Tb4b4b4)

Te6edf3fieldLinesTb4b4b4.Te6edf3addTb4b4b4(Ta5d6ff"Ta5d6ffpublic_key: Tffd700${Te6edf3userTb4b4b4.Te6edf3public_keyTb4b4b4.Te6edf3base64StringTb4b4b4(Tb4b4b4)Tffd700}Ta5d6ff"Tb4b4b4)

Tff7b72return Te6edf3fieldLinesTb4b4b4.Te6edf3joinToStringTb4b4b4(Ta5d6ff"Ta5d6ff\Ta5d6ffnTa5d6ff"Tb4b4b4)

Tb4b4b4}

Tff7b72private Tff7b72fun Te6edf3ByteStringTb4b4b4.Td2a8ffbase64StringTb4b4b4(Tb4b4b4)Tb4b4b4: Tffa657String Tff7b72= Te6edf3base64Tb4b4b4(Tb4b4b4)